package com.hc.common.service;

import java.util.Collection;
import java.util.List;
import java.util.Map;
import java.util.Set;

/**
 * @author hecai
 * @date 2021/12/21 9:08
 */
public interface RedisService<E> {
    /**
     * 四周
     */
    long WEEK_SECONDS = 4 * 7 * 24 * 60 * 60;

    /**
     * 列举出所有符合指定模式的key的集合
     *
     * @param pattern 模式
     * @return
     */
    Set<String> keys(String pattern);

    /**
     * 指定缓存失效时间
     *
     * @param key  键
     * @param time 时间(秒)
     * @return
     */
    boolean expire(String key, Long time);

    /**
     * 根据key 获取过期时间
     *
     * @param key 键 不能为null
     * @return 时间(秒) 返回代表为永久有效
     */
    long getExpire(String key);

    /**
     * 判断key是否存在
     *
     * @param key 键
     * @return true 存在 false不存在
     */
    boolean exists(String key);

    /**
     * 删除缓存
     *
     * @param key 可以传一个值 或多个
     */
    void del(String... key);

    /**
     * 普通缓存放入，使用系统默认的过期时间
     *
     * @param key   键
     * @param value 值
     * @return true成功 false失败
     */
    boolean set(String key, E value);

    /**
     * 普通缓存放入并设置时间
     *
     * @param key        键
     * @param value      值
     * @param expireTime 时间(秒) 如果time=-1 将设置无限期
     * @return true成功 false 失败
     */
    boolean set(String key, E value, Long expireTime);

    boolean multiSet(Map<String, E> map);

    /**
     * 普通缓存获取
     *
     * @param key 键
     * @return 值
     */
    E get(String key);

    /**
     * 普通缓存获取
     *
     * @param keys 键
     * @return 值
     */
    List<E> multiGet(Collection<String> keys);

    /**
     * 递增
     *
     * @param key   键
     * @param delta 要增加几(大于)
     * @return
     */
    long incr(String key, Long delta);

    /**
     * 递减
     *
     * @param key   键
     * @param delta 要减少几(小于)
     * @return
     */
    long decr(String key, Long delta);

    /**
     * 向一张hash表中放入数据,如果不存在将创建
     *
     * @param key        键
     * @param entryKey   项
     * @param entryValue 值
     * @return true 成功 false失败
     */
    boolean hset(String key, String entryKey, E entryValue);

    /**
     * 向一张hash表中放入数据,如果不存在将创建
     *
     * @param key        键
     * @param entryKey   项
     * @param entryValue 值
     * @param time       时间(秒) 注意:如果已存在的hash表有时间,这里将会替换原有的时间
     * @return true 成功 false失败
     */
    boolean hset(String key, String entryKey, E entryValue, Long time);

    /**
     * HashSet
     *
     * @param key 键
     * @param map 对应多个键值
     * @return true 成功 false 失败
     */
    boolean hmset(String key, Map<String, E> map);

    /**
     * HashSet 并设置时间
     *
     * @param key  键
     * @param map  对应多个键值
     * @param time 时间(秒)
     * @return true成功 false失败
     */
    boolean hmset(String key, Map<String, E> map, Long time);

    /**
     * HashGet
     *
     * @param key  键 不能为null
     * @param item 项 不能为null
     * @return 值
     */
    E hget(String key, String item);

    /**
     * 获取hashKey对应的所有键值
     *
     * @param key 键
     * @return 对应的多个键值
     */
    <V> Map<String, V> hmget(String key);

    /**
     * 删除hash表中的值
     *
     * @param key      键 不能为null
     * @param entryKey 项 可以使多个 不能为null
     */
    void hdel(String key, String... entryKey);

    /**
     * 判断hash表中是否有该项的值
     *
     * @param key      键 不能为null
     * @param entryKey 项 不能为null
     * @return true 存在 false不存在
     */
    boolean hHasKey(String key, String entryKey);

    /**
     * hash递增 如果不存在,就会创建一个 并把新增后的值返回
     *
     * @param key      键
     * @param entryKey 项
     * @param by       要增加几(大于)
     * @return
     */
    double hincr(String key, String entryKey, Double by);

    /**
     * hash递减
     *
     * @param key      键
     * @param entryKey 项
     * @param by       要减少记(小于)
     * @return
     */
    double hdecr(String key, String entryKey, Double by);

    /**
     * 将数据放入set缓存
     *
     * @param key    键
     * @param values 值 可以是多个
     * @return 成功个数
     */
    long sSet(String key, E... values);

    /**
     * 将set数据放入缓存
     *
     * @param key    键
     * @param time   时间(秒)
     * @param values 值 可以是多个
     * @return 成功个数
     */
    long sSet(String key, Long time, E... values);

    /**
     * 根据key获取Set中的所有值
     *
     * @param key 键
     * @return
     */
    Set<E> sGet(String key);

    /**
     * 根据value从一个set中查询,是否存在
     *
     * @param key   键
     * @param value 值
     * @return true 存在 false不存在
     */
    boolean sHasKey(String key, E value);

    /**
     * 获取set缓存的长度
     *
     * @param key 键
     * @return
     */
    long sGetSetSize(String key);

    /**
     * 移除值为value的
     *
     * @param key    键
     * @param values 值 可以是多个
     * @return 移除的个数
     */
    long setRemove(String key, E... values);

    /**
     * 如果不存在就往zset中添加一个元素
     *
     * @param key
     * @param value
     * @param score
     * @return
     */
    boolean zsetAdd(String key, E value, Double score);

    /**
     * 求Zset中元素的个数
     *
     * @param key
     * @return
     */
    long zsetSize(String key);

    /**
     * 删除指定的元素
     *
     * @param key
     * @param value
     * @return
     */
    boolean zsetRemove(String key, E value);

    /**
     * 删除指定区间的元素
     *
     * @param key
     * @param start 从0开始
     * @param end
     * @return
     */
    boolean zsetRemoveRange(String key, Long start, Long end);

    /**
     * 获取指定区间的元素
     *
     * @param key
     * @param start
     * @param end
     * @return
     */
    Set<E> zsetGetRange(String key, Long start, Long end);

    void zsetPopMin(String key);

    /**
     * 将list放入缓存
     *
     * @param key   键
     * @param value 值
     * @return
     */
    boolean lSet(String key, E value);

    /**
     * 将list放入缓存
     *
     * @param key   键
     * @param value 值
     * @param time  时间(秒)
     * @return
     */
    boolean lSet(String key, E value, Long time);

    /**
     * 将list放入缓存
     *
     * @param key   键
     * @param value 值
     * @return
     */
    boolean lSets(String key, List<E> value);

    /**
     * 将list放入缓存
     *
     * @param key   键
     * @param value 值
     * @param time  时间(秒)
     * @return
     */
    boolean lSets(String key, List<E> value, Long time);

    /**
     * 获取list缓存的内容
     *
     * @param key   键
     * @param start 开始
     * @param end   结束  到 -代表所有值
     * @return
     */
    List<E> lGet(String key, Long start, Long end);

    /**
     * 获取list缓存的长度
     *
     * @param key 键
     * @return
     */
    long lGetListSize(String key);

    /**
     * 通过索引 获取list中的值
     *
     * @param key   键
     * @param index 索引 index>=时，  表头， 第二个元素，依次类推；index<时，-，表尾，-倒数第二个元素，依次类推
     * @return
     */
    Object lGetIndex(String key, Long index);

    /**
     * 根据索引修改list中的某条数据
     *
     * @param key   键
     * @param index 索引
     * @param value 值
     * @return
     */
    boolean lUpdateIndex(String key, Long index, E value);

    /**
     * 移除N个值为value
     *
     * @param key   键
     * @param count 移除多少个
     * @param value 值
     * @return 移除的个数
     */
    long lRemove(String key, Long count, E value);
}
